﻿<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>FarMenuItem</title>
<meta http-equiv="Content-Type" Content="text/html; charset=utf-8">
<link rel="stylesheet" type="text/css" href="../../styles/styles.css">
<script language="javascript" src='../links.js' type="text/javascript"></script>
</head>
<body>

<h1>FarMenuItem</h1>
<div class=navbar>
<a href="../index.html">главная</a> |
<a href="index.html">структуры</a> |
<a href="../basicapi/index.html">Basic API</a>
</div>

<div class=shortdescr>
Структура <code>FarMenuItem</code> описывает один пункт меню. Массив этих структур передаётся в функцию <a href="../service_functions/menu.html">Menu</a>.
</div>

<pre class=syntax>
struct FarMenuItem
{
  MENUITEMFLAGS Flags;
  const wchar_t *Text;
  struct FarKey AccelKey;
  intptr_t UserData;
  intptr_t Reserved[2];
};
</pre>

<h3>Элементы</h3>
<div class=descr>
  <div class=dfn>Flags</div>
    <div class=dfndescr>Комбинация следующих значений (тип <a name="MENUITEMFLAGS">MENUITEMFLAGS</a>):
    <table class="cont">
    <tr class="cont"><th class="cont" width="40%">Флаг</th><th class="cont" width="60%">Описание</th></tr>
    <tr class="cont"><td class="cont" width="40%"><a name="MIF_SELECTED">MIF_SELECTED</a></td>
    <td class="cont" width="60%">Признак активности пункта меню. Только один пункт может быть активным.</td></tr>
    <tr class="cont"><td class="cont" width="40%"><a name="MIF_CHECKED">MIF_CHECKED</a></td>
    <td class="cont" width="60%">Признак отмеченного пункта меню. Перед текстом будет отображаться метка выбора.</td></tr>
    <tr class="cont"><td class="cont" width="40%"><a name="MIF_SEPARATOR">MIF_SEPARATOR</a></td>
    <td class="cont" width="60%">Пункт меню отображается как разделитель. Разделитель может содержать текст, выровненный по середине.</td></tr>
    <tr class="cont"><td class="cont" width="40%"><a name="MIF_DISABLE">MIF_DISABLE</a></td>
    <td class="cont" width="60%">Пункт меню недоступен.</td></tr>
    <tr class="cont"><td class="cont" width="40%"><a name="MIF_GRAYED">MIF_GRAYED</a></td>
    <td class="cont" width="60%">Если флаг установлен, то пункт меню доступен в навигации, но не доступен для выбора.</td></tr>
    <tr class="cont"><td class="cont" width="40%"><a name="MIF_HIDDEN">MIF_HIDDEN</a></td>
    <td class="cont" width="60%">Если флаг установлен, то пункт меню не выводится на экран.</td></tr>
    <tr class="cont"><td class="cont" width="40%"><a name="MIF_NONE">MIF_NONE</a></td>
    <td class="cont" width="60%">Нулевой флаг.</td></tr>
    </table>
    </div>
  <div class=dfn>Text</div>
    <div class=dfndescr>Указатель на текст пункта меню.</div>
  <div class=dfn>AccelKey</div>
    <div class=dfndescr>Код клавиши, структура типа <a href="farkey.html">FarKey</a>, для активизации пункта меню (HotKey). Пример работы - в меню Far Manager "Commands" нажатие клавиши <kbd>Ctrl</kbd>+<kbd>O</kbd> аналогично выбору пункта "Panels On/Off".</div>
  <div class=dfn>UserData</div>
    <div class=dfndescr>Пользовательские данные, ассоциированные с пунктом меню. Far Manager не использует это поле.</div>
  <div class=dfn>Reserved</div>
    <div class=dfndescr>Зарезервированные поля, должны быть равны <code>0</code>.</div>
</div>

<h3>Замечания</h3>
<div class=descr>
<ol>
<li>В младшем слове <code>Flags</code> можно указывать код символа, который будет использоваться для отображения метки выбора. В этом случае система самостоятельно выставит флаг <code>MIF_CHECKED</code> для данного пункта меню.</li>
<li>Если младшее слово <code>Flags</code> равно <code>0</code> и выставлен флаг <code>MIF_CHECKED</code>, или если младшее слово <code>Flags</code> равно <code>1</code>, то будет отображаться стандартная метка выбора - символ с кодом 0FBh (<code>&#8730;</code>)</li>
<li>При использовании флага <code>MIF_SEPARATOR</code> без текста, компонента <code>Text</code> должна быть проинициализирована в <code>0</code>, например так:
<pre class=code>
struct FarMenuItem Item;
Item.Flags=MIF_SEPARATOR;
Item.Text=NULL;</pre></li>
</ol>
</div>

<div class=see>Смотрите также:</div>
<div class=seecont>
<a href="index.html">структуры</a>
</div>

</body>
</html>